home *** CD-ROM | disk | FTP | other *** search
/ Power Programmierung 2 / Power-Programmierung CD 2 (Tewi)(1994).iso / c / library / dos / communic / spp / sppman.txt < prev    next >
Encoding:
Text File  |  1992-01-21  |  32.0 KB  |  1,268 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                           
  8.                                           
  9.                                           
  10.                                           
  11.                                           
  12.                                           
  13.                                           
  14.                                           
  15.                                           
  16.                                           
  17.                                           
  18.                                       Serial++
  19.                                           
  20.                         Interrupt Driven Serial Ports for C++
  21.                                           
  22.                              from Cortlandt Technologies
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                               
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                           
  74.  
  75.           
  76.           
  77.           
  78.           
  79.           
  80.           
  81.           
  82.           Serial++ Version 1.0
  83.           by Cortlandt Technologies
  84.           P.O. Box 195
  85.           Pleasantville NY 10570
  86.           
  87.           
  88.           
  89.           
  90.           
  91.           
  92.                                             _______
  93.                                        ____|__     |                (R)
  94.                                     --|       |    |-------------------
  95.                                       |   ____|__  |  Association of
  96.                                       |  |       |_|  Shareware
  97.                                       |__|   o   |    Professionals
  98.                                     -----|   |   |---------------------
  99.                                          |___|___|    MEMBER
  100.           
  101.           
  102.           This program is produced by a member of the Association of
  103.           Shareware Professionals (ASP).  ASP wants to make sure that the
  104.           shareware principle works for you. If you are unable to resolve a
  105.           shareware-related problem with an ASP member by contacting the
  106.           memberdirectly, ASP may be able to help. The ASP Ombudsman can
  107.           help you resolve a dispute or problem with an ASP member, but
  108.           does not provide technical support for members' products.  Please
  109.           write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442
  110.           or send a CompuServe message via CompuServe Mail to ASP Ombudsman
  111.           70007,3536.
  112.  
  113.           
  114.           
  115.           Copyright Notice:
  116.  
  117.           Serial++ is Copyright (c) 1991 by Cortlandt Technologies.  All
  118.           rights reserved.
  119.  
  120.           This manual is Copyright (c) 1991 by Cortlandt Technologies.  All
  121.           rights reserved.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                               
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.           
  140.  
  141.           
  142.           
  143.           
  144.           
  145.           
  146.           
  147.           
  148.           
  149.           
  150.           
  151.           
  152.           
  153.           
  154.           
  155.           
  156.           
  157.           
  158.           
  159.           
  160.           
  161.           
  162.           
  163.           
  164.           
  165.           
  166.           
  167.           
  168.           
  169.           
  170.           
  171.           Warranty Disclaimer
  172.  
  173.           CORTLANDT TECHNOLOGIES MAKES NO WARRANTY OF ANY KIND, EXPRESSED
  174.           OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY WARRANTIES OF
  175.           MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
  176.  
  177.           CORTLANDT TECHNOLOGIES DOES NOT ASSUME ANY LIABILITY FOR THE USE
  178.           OF THIS SOFTWARE BEYOND THE ORIGINAL PURCHASE PRICE OF THIS
  179.           SOFTWARE.
  180.  
  181.           IN NO EVENT WILL CORTLANDT TECHNOLOGIES BE LIABLE TO YOU FOR ANY
  182.           ADDITIONAL DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS, OR
  183.           OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE
  184.           OF, OR INABILITY TO USE, THIS SOFTWARE AND ITS ACCOMPANYING
  185.           DOCUMENTATION, EVEN IF CORTLANDT TECHNOLOGIES, HAS BEEN ADVISED
  186.           OF THE POSSIBILITY OF SUCH DAMAGES.
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                               
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                                   Table of Contents
  206.  
  207.                Introduction........................................4
  208.  
  209.                Hardware/Software Requirements......................5
  210.  
  211.                Installing Serial++.................................6
  212.  
  213.                Installing .LIB Library Files.......................7
  214.  
  215.                Installing .H Include Files.........................8
  216.  
  217.                Using This Manual and Serial++......................10
  218.  
  219.                     Serial Ports...................................10
  220.  
  221.                     Break Trapping.................................13
  222.  
  223.                     Memory Models..................................13
  224.  
  225.                     Serial++ with Overlays.........................14
  226.  
  227.                SerialPort Function Reference.......................14
  228.  
  229.                     constructor....................................14
  230.  
  231.                     destructor.....................................15
  232.  
  233.                     getBreakOff....................................16
  234.  
  235.                     getCommPort....................................17
  236.  
  237.                     getDataBits....................................17
  238.  
  239.                     getLSR.........................................18
  240.  
  241.                     getMSR.........................................19
  242.  
  243.                     getParity......................................20
  244.  
  245.                     getSpeed.......................................21
  246.  
  247.                     getStopBits....................................21
  248.  
  249.                     inbyte.........................................22
  250.  
  251.                     inmem..........................................23
  252.  
  253.                     instr..........................................24
  254.  
  255.                     isOwner........................................25
  256.  
  257.                     lineOK.........................................26
  258.  
  259.  
  260.  
  261.                               
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                     outbyte........................................27
  272.  
  273.                     outmem.........................................27
  274.  
  275.                     outstr.........................................28
  276.  
  277.                     sendBreak......................................28
  278.  
  279.                     setMCR.........................................29
  280.  
  281.                     unbyte.........................................30
  282.  
  283.                     constructor....................................31
  284.  
  285.                     destructor.....................................31
  286.  
  287.                     breakCt........................................32
  288.  
  289.                     isBreak........................................33
  290.  
  291.                     isCaptured.....................................34
  292.  
  293.                     isOwner........................................35
  294.  
  295.                     operator().....................................35
  296.  
  297.                     reset..........................................36
  298.  
  299.                     Serial++ is Shareware..........................38
  300.  
  301.                     Registration Information.......................38
  302.  
  303.                     Limited Distribution License...................39
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                               
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.           Introduction
  339.  
  340.           Serial++ is a library of small, safe, and efficient routines that
  341.           bring interrupt driven serial port support to your C++ programs.
  342.           It is compiled and linked with the Borland C++ compiler, and
  343.           supplied in the form of a set of ready to link object libraries.
  344.  
  345.           The routines in Serial++ are as easy to use as file i/o in C, yet
  346.           give you complete access to the registers of the 8250 UART,
  347.           should you require it.  They allow you to read characters from
  348.           and write characters to two serial ports simultaneously, in a
  349.           fashion very similar to stream i/o in C.  Support for iostreams
  350.           as defined in C++ version 2.0 is not available as of this
  351.           release.
  352.  
  353.           Implemented as C++ classes, the Serial++ library handles multiple
  354.           ports and multiple instantiations with ease.  The SerialPort and
  355.           BreakTrap classes contain all the internal housekeeping necessary
  356.           to deal with  multiple instances of the each class using a single
  357.           port.  It is because of this feature that Serial++ lends itself
  358.           nicely to event driven applications.
  359.  
  360.           Serial++ protects your applications from keyboard breaks,
  361.           (pressing the Control-Break or Control-C keys), to insure that
  362.           the necessary interrupt housekeeping is completed before
  363.           terminating,.  This guarantees that premature closing of a
  364.           Serial++ application will not leave your system with invalid
  365.           service routine addresses hooked to the serial interrupts..
  366.  
  367.           By default SerialPort will perform an orderly shutdown when a
  368.           break key is pressed, and exit to DOS. You can, however, specify
  369.           that keyboard breaks be handled in your own application code, in
  370.           which case SerialPort will continue to operate and ignore the
  371.           break. See the section on break trapping for details on how this
  372.           works.
  373.  
  374.           You can also use the keyboard break handling in Serial++ by
  375.           itself.  The BreakTrap class is entirely independent of the
  376.           SerialPort class.
  377.  
  378.           Serial++ is linked into your C++ programs just like any other
  379.           library.  There is absolutely no requirement for external TSR's -
  380.           - applications using Serial++ are completely self contained.
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                              4
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.           
  404.  
  405.  
  406.           Hardware/Software Requirements
  407.  
  408.           Serial++ may be used on any PC or PC-AT compatible computer,
  409.           running on an Intel(Tm) 8088, 8086, or 80x86 family processor or
  410.           compatible, that uses standard port addresses for COM1 and COM2.
  411.  
  412.           It is worth mentioning that Serial++ assumes that your serial
  413.           port hardware makes use of the National Semiconductor 8250 UART
  414.           chip, or a clone of it.  It is almost unheard of to find hardware
  415.           that uses anything else, so if you don't know what your serial
  416.           board uses, you're alright.  Be aware of this issue though, if
  417.           you use some sort of exotic or proprietary serial boards in your
  418.           machine.  When in doubt, try executing the demo program on your
  419.           target machine.
  420.  
  421.           While Serial++ is unaffected by machine speed, and has been run
  422.           on machines operating at 4.77 to 33 MHz, it does expect to find
  423.           the serial ports and interrupt vector addresses at very specific
  424.           locations:
  425.  
  426.           Device    Base i/o Address    Int. Vector Address
  427.           COM1:     0x03F8              0x000C
  428.           COM2      0x02F8              0x000B
  429.           
  430.           Keyboard:
  431.           Ctrl-Brk  n/a                 0x0023
  432.           Ctrl-C    n/a                 0x001B
  433.  
  434.           If you have difficulty getting the demo program to work, you
  435.           might want to consult the technical documentation that comes with
  436.           your computer to verify the addresses shown above.
  437.  
  438.           Serial++ requires MS-DOS, version 2.11 or higher. [The library
  439.           has been tested and works with version 5.00].  Serial++ uses DOS
  440.           functions for saving, setting, and restoring interrupt service
  441.           routine addresses.
  442.  
  443.           While it is running, Serial++ traps the interrupts mentioned in
  444.           the table above.  Although it restores the addresses of the prior
  445.           service routines upon exit, while it is running Serial++ could
  446.           interfere with any TSR's that utilizes any of the listed
  447.           interrupts.  Consult the documentation of any TSR's you use that
  448.           provide serial communications or respond to the Control-Break or
  449.           Control-C keys.
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                              5
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.           
  470.  
  471.  
  472.           Installing Serial++
  473.  
  474.           Serial++ is distributed as a self-extracting archive file,
  475.           SPP.EXE.  The first step in installation is to copy this file
  476.           into a work directory and execute it by typing:
  477.           
  478.                C:>spp
  479.           
  480.           at the DOS command prompt.  SPP will announce each file as it is
  481.           unpacked looking something like this:
  482.           
  483.  
  484.             . . .
  485.             
  486.             READ.ME .
  487.             PACKING.LST .
  488.             SPPL.LIB .
  489.             BREAK.H .
  490.             SERIAL.H
  491.             SPPS.LIB .
  492.             . . .
  493.             
  494.  
  495.           After you have expanded SPP.EXE into its component files, you may
  496.           delete it from your install work directory, to save space.
  497.  
  498.           The first file to check is READ.ME, which may contain updated
  499.           information about Serial++.  You may also wish to examine the
  500.           contents of PACKING.LST, which lists every file in the package,
  501.           along with a brief description.
  502.  
  503.           The files included in the Serial++ package fall into the
  504.           following groups:
  505.  
  506.             >  Library files, SPPx.LIB.  There is one library file for each
  507.                  memory model supported by Serial++.
  508.  
  509.             >  Include files, *.H. These are C++ source includes that
  510.                  define the public interface of the classes that make up
  511.                  Serial++.
  512.  
  513.             >  Demo related files, *.CPP, *.BAT, *.MAK, etc. These files
  514.                  are included to provide you with some examples of how to
  515.                  use Serial++.  They include an executable demo program,
  516.                  SPPDEMO.EXE, which is ready to run.
  517.  
  518.             >  Documentation, READ.ME, PACKING.LST, and the file that
  519.                  contains this document, SPPMAN.TXT.
  520.  
  521.           In order to begin using Serial++, you must place the library and
  522.           include files in a directory where the C++ compiler and linker
  523.  
  524.  
  525.                              6
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.           can 
  536.  
  537.   ting,.  Thisright.  B and linker
  538.  
  539.  
  540. n your
  541.        k
  542.    Ps t    e Borlak
  543.   DEMOing 
  544.           s of thi
  545.  
  546. t place the library a          
  547. ,          hat make up
  548. e spt files
  549.                 containsde files  
  550.  
  551.  
  552.        hey iMAN.TXT  machine.  Whenntirely thibwitn that your seri LibrarompaplXT.
  553. tilizes anyhousekeeping is ition, READ.Ms usipanded SPP.w execannoums
  554.        i/o in C. rhing like this:
  555.           
  556.  
  557.     6       . . .
  558.             
  559.      
  560. our cecannm       
  561.     s    e Dopd proma     w execao e, i
  562.  
  563.  
  564.          s READ.ME,am to lre maibws o   SPPSplXT.mmputer,
  565.           run
  566.           
  567.  /o iur
  568.  EAD.Ms 
  569.  
  570.  
  571. he rs Rdeta*.Bthoug,
  572.   yary files, SPPx.bPSplXT.         he faufrom
  573. or each
  574.   pt.  m   
  575.   intoekeeping is it    . . .
  576. .          READ.ME .
  577.             Serial+F C++ cK, etc. These figoof a
  578.   anno     EAD.Ms 
  579. ao     annmde you wiizes any of the listse
  580.    ude
  581.    if ybyrt for iostreams
  582. n C. r, TLINK.an execdoes expect to firont   y
  583. ao ins    fine  infor like this:
  584.  1+ us    wiizes ani.Ms usng:
  585. nded SPP.w execibranourclly           containsde     i/o in C.     fashiy be us iostreams
  586.              compiler and linkerutorce ccllytse
  587.    u     urrrom
  588. or each
  589. ,
  590.            compiler and linkeles
  591.  to ls ftlyta works usip            usng:
  592.  save sp   e compiler and linke
  593.  
  594.      save sp   e
  595.        e to opei++
  596.  
  597. rt.
  598.  
  599.  
  600. uter,
  601.           runect to firontopd pro.     ng:
  602. nded SPP.ibra      following gro         runect to h
  603.  
  604. ens thibwsng:
  605. nded SPP.w execibrade     i/o in C.
  606.    Ps t    e Borlakone lzes ani.Msr
  607.  
  608.  
  609. .
  610.   ed!or like this:
  611.  - ORioni like this:
  612.  2    py
  613.           (pressini.Ms uyou wiianded SPP.w execann   Ps t    e Borlakoprietaryressini.Ms        ybyrs iostre  S   e to op           contains nded SPP.s ope  drutorce ccllytse
  614.    f ybyrt fo
  615.        e           containsnntratinit    . . .
  616. s,
  617.  n dou Brebiianded SPP:           contains like this:
  618.          \BORLANDC\    compiler and linke
  619.           can 
  620.  
  621.   nle.
  622. the
  623.     deangedrial++ self. s iostreanded SPP
  624.           can 
  625.  
  626.  naesse tF is ng:
  627. nded SPP.w execibra      following 
  628.    Ps t    e Borlakce    Ba s R, to save ss:           contains like this:
  629.          e i   PYllow?      \BORLANDC\    compiler and linkeeeeeeeeeeeeee(    vec    ,
  630.          Ke this
  631. )           contains like this:
  632.          e i DELllow?     compiler and linkeeeeeeeee(ao     ride
  633.  
  634.     s
  635. adyial+   i.M.)           contains like this:
  636.       or like this:
  637.  - ORioni like this:
  638.  3+ us    wiizes ani.Ms usng:i Thereor each
  639.   stredeangecann   Ps t    e Borlak
  640.        'sizes anyhse
  641.    ude
  642.  e to ope   
  643. biiins    fin. These are C+ing is it s    e D  y
  644. :           contains like this:
  645.                      s iostreIDEk
  646.        ,re is a
  647.   usng: like this:
  648.       environmmput       Opd promDr each
  649. i.ME,atre    you with some exam, SPPx.bPitnn break.ght wa
  650.    ude
  651.    wiianded SPP. orde     compiler and linkede files
  652.           (pressini.M.         wfin.      lXT.         runect to finmde ianded SPP.\      It i
  653.  
  654.  
  655. ,ed in ywizes anyhse
  656.    hing like this:
  657.           
  658.  
  659.     7 looking something like this:
  660.       de
  661.         ntai     :           contains like this:
  662.          \   ;\BORLAND\   ;...           contains like this:
  663.       
  664.  
  665. suxecao      d inenvironmmput intoer t Serial+deangecbP
  666.           can 
  667.  
  668.         SerOpd promS    f is ng:
  669. mmpu.           contains like this:
  670.         I wort   ly,cibrade Bre        sCIN, wps the i         like this:
  671.       a
  672.   s iostreams
  673. ao r to ial+deangec     s usng:
  674. IDE like this:
  675.       ds the ial++ m, sC      Agile,e    y
  676.  
  677.   th you with some exam, SPPx.       (pressinypanded SPP.EXE     ctedl usnou with some exam, SPPx.bPitnn break.ght zes anyhse
  678.    ude
  679.  e           contains like this:
  680.              prefly t    save sp   e
  681.         sCCing 
  682.  
  683.    as it is
  684.    
  685.       a
  686.  des de figur   
  687.     >  Libra   
  688. you e   d insaess it is
  689.    
  690.         Slf. am P, *.Bb 
  691.       sbyrthat yt fo
  692.        ntioL
  693.           can 
  694.  
  695.   a
  696. c e tAs      ,+deangat yt fo a
  697. c  thi
  698. s o:           contains like this:
  699.          -L\   ;\BORLANDC\   ;...           contains like this:
  700.       ou Bre
  701.  
  702. .ert y
  703.  
  704.   th you Ke hypot fe ccl       PACKike this:
  705.       ressini.Ms nded SPP.suyou wiise
  706.    ude
  707.  e          READ.ME .
  708.        Htation, RF C++ cK, etc. Thes  Installte us iostreams
  709.         eandD.Msse
  710.          Itition, th some exampAD.Msa rettlle it erromlP. orn ressini.M,les,as ccllytsimila distributed aREAtegy      ile f  Itit.
  711.       
  712.     rief de.EXE        ekeeping is ition, READ.M.or like this:
  713.  1+ us    wiiition, READ.Ms usng:
  714. nded SPP.w execibranourclly           containsde     i/o in C.     fashiy beopei++
  715.  
  716. + self. situ   
  717.          runect to firectoryams
  718.         to wortio-a
  719.  
  720.  
  721.  
  722.  
  723.  
  724. be  Ie/o Address    In
  725.           
  726. nded SPP.ibra      following gro h
  727.  
  728. ens thibwsng:           contains nded SPP.w execibrade     i/o in C.
  729. cibr'r:
  730.  ne!or like this:
  731.  - ORioni like this:
  732.  2    py
  733.           (pition, READ.Ms uyou wiianded SPP.w execann   Ps t    e Borlakoprietaryition, READ.Ms  S   e to ops nded SPP.s ope   compiler and linkerutorce ccllytse
  734.    f ybyrt fo
  735.        ensnntratiThese are C+ing is it    . . .
  736. s,
  737.  n dou Brebiianded SPP:           contains like this:
  738.          \BORLANDC\INCLUDE like this:
  739.       
  740.           can 
  741.  
  742.   nle.
  743. the
  744.     deangedrial++ self. s iostreanded SPP
  745.           can 
  746.  
  747.  naesse tF is ng:
  748. nded SPP.w execibra      following 
  749.    Ps t    e Borlakce    Ba s R, to save ss:           contains like this:
  750.          e i   PYllrief de. \BORLANDC\INCLUDE like this:
  751.          e i   PYl        . \BORLANDC\INCLUDE like this:
  752.          eeeeeeeeee(    vec    ,
  753.          Ke this
  754. )           contains lng like this:
  755.           
  756.  
  757.     8 looking something like this:
  758.          e i DELl       ekeeping is 
  759.          e i DELllrief description.
  760.  
  761. linkeeeeeeeee(ao     ride
  762.  
  763.     s
  764. adyial+   i.M.)           contains like this:
  765.       or like this:
  766.  - ORioni like this:
  767.  3+ us    wiiition, READ.Ms usng:i Thereor each
  768.   stredeangeddress    In
  769.           
  770.        ntiition, Rse
  771.    ude
  772.  e to ope   
  773. bi compiler and linkerns    fin.  it s    e D  y
  774. :           contains like this:
  775.                      s iostreIDEk
  776.        ,re is a
  777.   usng: like this:
  778.       environmmput       Opd promDr each
  779. i.ME,atre    you with some exam, SPPx.bPitnn break.ght ition, Rse
  780.    ude
  781.    wiianded SPP. ords it is
  782.    
  783.       a
  784. llede files
  785.           (pition, READ.M.         wfin.     like this:
  786.       dlXT.
  787. tilmde ianded SPP.\      It i
  788.  
  789.  
  790. ,ed in ywiition, th some examhe listse
  791.    ude
  792.         ntai     :           contains like this:
  793.          \   ;\BORLAND\INCLUDE;...           contains like this:
  794.       
  795.  
  796. suxecao      d inenvironmmput intoer t Serial+deangecbP
  797.           can 
  798.  
  799.         SerOpd promS    f is ng:
  800. mmpu.           contains like this:
  801.         I wort   ly,cibrade Bre        sCIN, wps the i         like this:
  802.       a
  803.   s iostreams
  804. ao r to ial+deangec     s usng:
  805. IDE like this:
  806.       ds the ial++ m, sC      Agile,e    y
  807.  
  808.   th you with some exam, SPPx.       (pition, READ.Msanded SPP.EXE     ctedl usnou with some exam, SPPx.bPitnn break.ght ition, Rse
  809.    ude
  810.  e           contains like this:
  811.              prefly t    save sp   e
  812.         sCCing 
  813.  
  814.    as it is
  815.    
  816.       a
  817.  des de figur   
  818.     >  Libra   
  819. you e   d insaess it is
  820.    
  821.         Slf. am P, *.Bb 
  822.       sbyrthat yt fo
  823.        ntioI
  824.           can 
  825.  
  826.   a
  827. c e tAs      ,+deangat yt fo a
  828. c  thi
  829. s o:           contains like this:
  830.          -I\   ;\BORLANDC\INCLUDE;...           contains like this:
  831.       ou Bre
  832.  
  833. .ert y
  834.  
  835.   th you Ke hypot fe ccl       PAiition, th some examhe listEAD.Msanded SPP.suyou wiise
  836.    ude
  837.  e          READ.MGet  SerStay to cK, etc. These fifirsecto Ser    wf   iaputyou PP.s oyouer
  838.  
  839. wsng:
  840.  m K, etc. Thesds the i reali.   
  841.         PA:k
  842.   DEMOing . cK, etc. These opei++a    y
  843. rt.
  844.  
  845. sds the ifirec
  846.  m naREAtes    6
  847. ak.ght ,as c        
  848.     pabireti
  849.  
  850.  
  851.  
  852.           (p      I. I. als o
  853. the
  854. you 
  855. en a        
  856.    e fars   
  857.  
  858.  e
  859.     s      adytE,atre cceprtiaRE Ses f is ng:        
  860.   keybotaryao  en  you wi adytE,atrewaal+ up you wo  e e ds,
  861.            
  862.   replytf is ng:
  863. adyt
  864.        t echoes you wi  *.een. cK, etc. These opeds the iase   ful.bPca     t        ++a quick+deeck+ ords it is
  865.           (p     ile f 
  866.     Ke htarwr
  867. ensntope  dg   
  868. the
  869. a lng like this:
  870.           
  871.  
  872.     9 looking something like this:
  873. rt.
  874.  
  875. sile  Ser i
  876.  
  877.  
  878.  
  879.  
  880.  
  881. s Kec  
  882.  deifirecibra   
  883. de     i/o  like this:
  884. n C. youdeeck+des   Ke it    . . .
  885.  
  886.  
  887.        (. cK, etc. Thes      r
  888. de  untoeaseequi
  889. e   
  890.      may tra
  891.  m,r    wf   fitreids it is
  892.    a eandyudertntoe
  893.    PP breaes 
  894.   DEMOing . Tryrthat y
  895.   DEMO    like this:
  896.  en   save ss you wi ra
  897.  mio-r    shu Bresont
  898.   DEMO echo ng:        
  899.   ra
  900.  mntiacknow edg.mmpus  usng:
  901.  *.een. cK, etc. Thes       
  902.      it iclf.y
  903. de    at y/o in C.at y
  904.   DEMO that yt f like this:
  905.  reali.  r to    >,+deeck+ oe de figur   
  906.  s    
  907.  rectorybottor like this:
  908.  
  909.  
  910.    r to    >,+/o i
  911.    TLINK  save s,e
  912.    ht zes anyh/o  like this:
  913. ition, Rse
  914.    ude
  915.  se tM to suxecairectoryde
  916.  sta works ustoryoI
  917.           c/o i-L
  918.          a
  919. c  
  920. rce  u    it    . . .
  921.  
  922.  
  923.     
  924.         like this:
  925.  
  926.     Ke myou ne. cK, etc. Thes
  927.   DEMOiC   shuw++a rt.
  928.  
  929. s i
  930.  
  931.  
  932.  
  933.  
  934.  
  935. huw you              Pdyt        
  936.        e
  937.   
  938. s oat y/o iwri  Se;e
  939.   m    o     r
  940. aealic . .
  941. s
  942.  n  like this:
  943. ne  l o  s    exity      ratin    lytbiii   ibraneed.  
  944.  
  945. suxecao like this:
  946. bruw+    rstallte ufun   
  947.  reflyencecao     a s    e
  948. wspictuxe like this:
  949.  
  950.  
  951.    f exibirety
  952.  
  953.  
  954.           (pzes anye          READ.MUhat ye opeManu   /o i      PACK      READ.MPerh
  955.  
  956. ++
  957.  
  958. betin  y thibwc  6
  959. acquilet.   
  960.         PA.s oyo      READ.Mt to ial+sa.
  961.  
  962. sds the ,s
  963.   DEMOiC  ,+/o ira
  964. ify  t ao  uis   K      READ.Mneedse tHow    ,byrreviewat y   6
  965. backgrsto i usng:
  966. let.wor  compiler anile  Se
  967.  
  968.  
  969.          Pdyt.EXE  
  970. s kTrapp      I,+/l ug  
  971.  th some exampun   
  972.  reflyencecairecfols o
  973. ,r    wf   biiiblecao wri ey   6th some exam   y
  974. rop ope cct.  s      adyt eandDat yr     f is C (. cK, etc. These fifols oat y     
  975. sede fileses,ni.f P, *.Bp. .
  976.  
  977.  
  978. huws it is
  979.          Pdyt.EXE  
  980. s kTrappr
  981. iaREuctuxed,+/o i       y   6th some examprace ccl infourc. .
  982.     wf   needcao knowcao      wi ratinaes like this:
  983.  
  984.  
  985.    package.or like this:
  986.         Pdytsor like this:
  987.  e fifirsectwo  e     adytMs us  Ke this
  988. ,   M1:+/o i  M2:,pr
  989.  like this:
  990.   reaoy tof  Itit un+/o iaes un+byrt fo
  991.     e      Pdyte tY K      READ.M  wf   needcrecleatinan  it   ncec
  992.  
  993.       Pdyt.  It a  uddyt.y K      READ.M  wfsh you     us  Ke ds the e tY K m y 
  994.     moxecair
  995.  
  996.  
  997.  like this:
  998.  it   ncec
  999.  
  1000.       Pdyt.   ociat.   
  1001.    a  udhys ccl adytE,buds it is
  1002.    
  1003.  onlyt
  1004.  
  1005. ,ed infirsecit   ncecthibws*.eat. , a
  1006. llede frolu with some exam, ddyt.deraest.wse tAe  , ng:
  1007. adyt
  1008.  
  1009. lleremilesto ly t    s frols it is
  1010.    
  1011.  ofs  Ke ds the stotilcairecfirsec      Pdyt.it   nce, ng:
  1012.  
  1013.  
  1014.  like this:
  1015.         
  1016. enedrial+adytE,p    Ieaes 
  1017.  
  1018. s    i/o iham its like this:
  1019.  P, REuct It i
  1020.  
  1021. wd.  We a
  1022. llede 6
  1023. back you wopedoiput gile like this:
  1024.  . .  ,ram itiham a m j It t ecinan
  1025. huw     wf   iaputyo like this:
  1026.  it   ntiat.c      Pdyt.objworti us  Ke ds the M.or like this:
  1027.  T         Pdyt.
  1028.     ede sope
  1029.  
  1030.  
  1031. wo adyt 
  1032. s:nan  adyt 
  1033.  is like this:
  1034.     e c, hidden f is    r
  1035. aealic . .
  1036.  
  1037.  deiatre l  y
  1038. s  S   nt. like this:
  1039.  T opedoyt 
  1040. ,
  1041.        s reflyredcao as ng:
  1042. adyt
  1043.  nch It(    wf   lng like this:
  1044.           
  1045.  
  1046.     10 looking something like this:
  1047.  noe ceia reflyencecao aiaREuctuxe naesd PdytAnch It usng: like this:
  1048.  + sini. .
  1049.  
  1050.  
  1051.     e      Pdyt),ede filessng:
  1052. let.wruput  rv ce like this:
  1053.  rstt  e
  1054.  de,+/l ug  
  1055.  ses,lock+df Pata requiredcao   rv ce like this:
  1056.  ng:
  1057. adyt.to ops ata ition, tiau  u   Se
  1058. as ng:
  1059. adlet.wsnou with some exam, but eru   of  Itpdyt.it un,+/o iitnticurrromtpdsi. .
  1060. e to e
  1061.  like this:
  1062.       :
  1063. adyt
  1064.  nch It  It a  u
  1065.  
  1066.     swo ahys ccl adyts like this:
  1067.   reaoy to,+/o i a  uasee
  1068.     busyt
  1069. r
  1070. availablec  It    byh/o like this:
  1071.  it   ntiat .
  1072.  
  1073.  
  1074.       Pdyt.  Itng:
  1075. ur   
  1076.  ofs  Ke ds the .or like this:
  1077.  T   dynaeicudert
  1078.  
  1079.  
  1080.     e      Pdytei++
  1081.  
  1082. adyt 
  1083.  airec   s like this:
  1084.  *.eat.   
  1085.    a  uit   ntiat .
  1086. : itidedords ng:
  1087. adyt
  1088. deraest.ws like this:
  1089.      set
  1090.   e
  1091.     *.eat.  in,+/o iadlets you wi adyt
  1092.  nch I like this:
  1093.  *orrrspe dat ytou wi adyt
  1094.     s woifirks ustoryc naREuct I like this:
  1095.  *i  . Ea  uit   ncec
  1096.  
  1097.       Pdyt. e  dknowm if,
  1098.     ng:
  1099.  
  1100. wners it is
  1101.    
  1102.  ofs wi adyt
  1103.  nch I: if,
  1104.     ng:
  1105. firsecit   ncecthirefly to like this:
  1106.  ngat+adytE,
  1107.    paraest.ws
  1108.     s woifirks(   + self.edcao) rds it is
  1109.    
  1110.  *.eat 
  1111.  ai 6
  1112. axe aeali.  you wi adyt
  1113.  nd ngat+it   ncec
  1114. wns like this:
  1115.  ng:
  1116. adytstotilc
  1117.     P, REoywd.or like this:
  1118.  Onlytng:
  1119.  
  1120. wner+it   ncec   
  1121. s    wi s wto,+parety
  1122.  ata  nd stopth some exam, biut  t  Ser
  1123.     adytE,atreng:
  1124. adytsope lo  ofonlyt  e
  1125. its like this:
  1126.  
  1127. wner+i  P, REoywd. tY K m y *.eat.  nd P, REoy
  1128. as m    o
  1129.     like this:
  1130.  it   nces
  1131.  
  1132.  
  1133.       Pdyt.  Itadg   n ahys ccl adyt
  1134. as ibraneed,s it is
  1135.    
  1136.  onlytng:
  1137.  
  1138. wner+wf   s    wi adytstp,t
  1139. r
  1140.  lo  c
  1141.  d
  1142. wn. like this:
  1143.    Ihstallte us   up paraest.ws
  1144. ofs wi  e e d  nd subsequrom like this:
  1145.  it   nces
  1146.  
  1147.  
  1148.       Pdyt.  Itadg   n ahys ccl adyt
  1149. axe ignored,s it is
  1150.    
  1151.  i   ak.ght it   nces
  1152.    
  1153. s oy/o iwri e you wi adyte to ey wf   lit is
  1154.    
  1155.  i   do  ocrecthat yt foparaest.ws
  1156. , Rablfin.    e
  1157.  wi adyt like this:
  1158.  
  1159. wner+it   ncecwas *.eat. .or like this:
  1160.  F It i
  1161.  
  1162.  
  1163. ,e ustoope  deifragmmpu:ng like this:
  1164.           Pdyt.
  1165. om1(  M_1,B_2400,D_8,P_N,S_1); like this:
  1166.     . . . like this:
  1167.           Pdyt.* yw
  1168. om =n ywi      Pdyt(  M_1,B_1200); like this:
  1169.     . . . like this:
  1170.     
  1171. om1.stt RE("Hels ,ileld"); like this:
  1172.      yw
  1173. om->stt RE("\n...via ra
  1174.  m!\n"); lth some exam, bo
  1175.   it   nces
  1176. adletat ytou  M1:, 
  1177. om1y/o i yw
  1178. om, a
  1179. lleaes un like this:
  1180.    E Ses you wi adyt
  1181.  t 2400
  1182. baudE,
  1183.    valu us   rectory*.eat 
  1184. s it is
  1185.    
  1186.  ofs wi 
  1187. wner+it   nce, 
  1188. om1.or like this:
  1189.  Not.  e  d ustoope i
  1190.  
  1191.  
  1192.  
  1193. ngat+  e
  1194.  
  1195. om1ygo Ieaes 
  1196.  
  1197. s    i/o  like this:
  1198.     P, REoywd,eng:
  1199. adytsope lo  o.     it   ncec yw
  1200. om pe    lit is
  1201.    
  1202.  exipe
  1203.  intoengat+h
  1204.  
  1205. enI,+/l  /ts
  1206. pts you savun cct.snou with some exam, adyt
  1207.  
  1208.    yw
  1209. om  
  1210. lleretux
  1211.  err It   euME,atrelet.wrogatat  like this:
  1212.  ng:
  1213.    euM ofs wi adyt
  1214.   rstall yw
  1215. om  
  1216. lleshuw yht ze
  1217.  
  1218.  like this:
  1219.  unavailable.or like this:
  1220.  T opeiet.wor  
  1221.    i ectuxe 
  1222.  
  1223.       Pdyt. es o
  1224. the
  1225. yo like this:
  1226.  iti. alizes  Ke ddytMse
  1227.  lyi us  Ke ds the ,+perh
  1228.  
  1229. ++bP
  1230.           cande
  1231.   rat y/c      Pdyt.it   nce ofs   >
  1232. s    ii    Ke myle like this:
  1233.  ra
  1234. u >,+/o i
  1235.   usnou*.eat.   s
  1236. po anyhit   ncec   w e
  1237. .y K  ng like this:
  1238.           
  1239.  
  1240.     11 looking something like this:
  1241.  needca rstaldes   Ke ds the ifoe ccessrial+adytE,a
  1242.  des  with some exam, needcao p    
  1243.  sto i rnde
  1244.   r.   globcl adlet.wsnou wi adyte like this:
  1245.    lc      Pdyt.it   nceME,
  1246. wnersi rnnoe,
  1247.    
  1248. fitre/o i       s it is
  1249.    
  1250.  o
  1251. en adyt
  1252.  o
  1253.       t ey refly.or like this:
  1254.  Ano
  1255.    +dearace   pe c
  1256.  
  1257.  
  1258.       Pdyt.ngat+isnile
  1259.    otat :    s it is
  1260.    
  1261.  it un+/o iaes un+membtoe
  1262. un   
  1263. s
  1264.  
  1265.  
  1266.       Pdyt. r.     lit is
  1267.    
  1268.  de
  1269.   r.d virtu  .
  1270.  T opefaciretAtes *.eat t y ly   dp      I lit is
  1271.    
  1272.  f is       Pdyt, if,    wfsh youperfoury   6
  1273. preds cess breaks it is
  1274.    
  1275.  it un+  Eee M,t
  1276. r
  1277. pdst-ds cess breakiaes un+  Eee M.es       do like this:
  1278.     rrideiat it   it.  i/o+membtoe
  1279. un   
  1280. ,ibwssuxecao *i      s it is
  1281.    
  1282.  *orrrspe dat y      Pdyt.rstt  e
  1283. f is    r
  1284.  ywirstt  e
  1285. yo like this:
  1286.  perfouryyht aceucl adyt
  1287. i/o.or like this:
  1288.  L  e
  1289. /o iadrt
  1290.    euM 
  1291. un   
  1292. s
  1293.  r.  ot virtu  ii        Pdyteor like this:
  1294.  Oninfior   ote: if,    look rectory+ sini. .
  1295.  
  1296.  
  1297.       Pdyt.it like this:
  1298.   ERIAL.H,r    wf   noe ceiairectoryderaest.ws
  1299. p    dsnou with some exam, c naREuct I
  1300. /o iretux
  1301.  dsbyrt fo   ...()+membtoe
  1302. un   
  1303. s
  1304. r
  1305.  like this:
  1306.  i   d sinedcrMsenum valu s,hit  s oy
  1307.  
  1308. st.
  1309.  
  1310. siet.g.wse tThis like this:
  1311.  was d  :
  1312.   Itnwhireas
  1313. s:n
  1314. firse,
  1315. stncecratinafs wisith some exam, aeraest.ws
  1316.  ccepr  i *.et. r  htoenganede finuouM valu s,hthat  lit is
  1317.    
  1318.  enums+isnaneeasyn  y thi     wi 
  1319.         t d usuxecairecnonaes like this:
  1320.  ofsrang  valu s wf   biip    dsas.deraest.wseor like this:
  1321.  T    e e d reas
  1322.     ngan+byr+ siniSer nums+ 
  1323.      r- like this:
  1324.  reaniSeful.naess,yyht aceucl valu s p    ds   
  1325. biiwgan     is like this:
  1326.   e   niromtf is a s dat ydoiputofsview.es       look rector lit is
  1327.    
  1328.  enums+rectorybeginn breaki ERIAL.H,r    wf   noe ceiaire like this:
  1329.  i Ihstallte uvalu unaess r to  enseE,
  1330.    valu srialmselv I lit is
  1331.    
  1332.  reallyid  'e,
  1333. stt idei
  1334.  
  1335.     
  1336.  et.xti
  1337.  
  1338.     
  1339.  deifirecu  I lit is
  1340.    
  1341.  ialmeor like this:
  1342.   
  1343. s k Trappat  l like this:
  1344.        Pdyt.u  I keyboardsb
  1345. s k trappat  t d usuxecaiaaf i/o  like this:
  1346.  s    e
  1347. wsshutd
  1348. wns ustory   putofsa    ri  nerat.  keyboardth some exam, b
  1349. s k.  
  1350. y + self.,       Pdyt. 
  1351. llerestor.    
  1352. let.wruputh some exam, vect Is you wiirt
  1353. rigior  addres  I atrelmesdiat.lyiexit youDOS like this:
  1354.    e
  1355. it + twortia keyboardsb
  1356. s k.es t wf   noeeretux
  1357.   s frols it is
  1358.    
  1359.  you  Ke ds the ibefor. exitat y/intoeasb
  1360. s k.esCeeck Ser
  1361.    s it is
  1362.    
  1363.  yrapp.  keyboardsb
  1364. s k    ng:
  1365. firseca   
  1366.  perfourrks usi   ak like this:
  1367.  ng:
  1368. i/o+membtoe
  1369. un   
  1370. s,+/o iratinafs wi
  1371.    euM 
  1372. un   
  1373. s
  1374. ak like this:
  1375.        PA;,bud biiiwaxecairec  Ke ds the icould runr
  1376.   quit
  1377.  like this:
  1378.     6
  1379. ai 6
  1380. totilcaiec yxt s      adyt o
  1381. er   
  1382.   i *   r  ngan+ s it is
  1383.    
  1384.  keyboardsb
  1385. s k ham occurrrd.or like this:
  1386.  T opebe
  1387.   i
  1388. r
  1389.    
  1390. bii   rridden byr  t  Ser
  1391.          Pdytth some exam, c naREuct I
  1392. deraest.wsb
  1393. k_off non-zero (REue).
  1394.  T opeflag like this:
  1395.  *iu  I       Pdyt.no ignore yrapp.  b
  1396. s ks,+/o ide finue
  1397. yo like this:
  1398.   i
  1399.  
  1400. w,a
  1401.  des let.wrupu .
  1402. eor like this:
  1403.                   Pdyt. 
  1404.   b
  1405. s ks ignored,     m y wfsh youyrap like this:
  1406.  io ihandDe keyboardsb
  1407. s kti us  Ke 
  1408. wnsaealic . .
  1409. .
  1410.  T opeis  ng like this:
  1411.           
  1412.  
  1413.     12 looking something like this:
  1414.  easilyid    byhition,at y/n.it   nce ofs
  1415.     
  1416. s kTrapp     .it like this:
  1417.    Ke ds the .or like this:
  1418.   
  1419. s kTrappisnam   y
  1420. rt.
  1421.  
  1422. s     .ngat+aerfoursctwo  e v cesr
  1423.   like this:
  1424.    Ke ds the .  Firse,
  1425. it yr
  1426.  
  1427. ++keyboardsb
  1428. s kti(Cs frol- 
  1429. s k like this:
  1430.  io iCs frol-C),epre  pu Ser
  1431.   mtf is let.wrupu Ser  Ke ds the , like this:
  1432.  io i e e d it        m a medeanismr
  1433.     Ke ds the ifo lit is
  1434.    
  1435.  det.wm  e
  1436. ifia keyboardsb
  1437. s k ham occurrrd. tY K m y fre.lys it is